Graph 收信指南：如何使用 OAuth2.0 接收 Hotmail 和 Outlook 邮件

本文介绍如何使用微软 Graph（OAuth2.0）收取 Hotmail/Outlook 邮箱邮件，并说明 Refresh Token 和 Client ID 在 Graph 收信中的作用。Hotmail007 提供的邮箱账号包含令牌信息，用户可以通过 API 文档快速获取最新邮件，也可以使用 Python 示例代码自行接入微软 Graph。本文适合需要批量购买 Hotmail 账号、批发 Outlook 邮箱、验证码邮件读取和自动化收信的用户参考。

微软 Graph（Microsoft Graph，OAuth2.0）是微软官方提供的主流邮箱数据访问方式，可用于读取 Hotmail、Outlook 等微软邮箱中的邮件内容。相比传统邮箱协议，Graph API 更适合验证码邮件读取、自动化收信、批量账号管理和系统集成，收信速度也比较快。

Hotmail007 提供的 Hotmail/Outlook 邮箱账号都包含 Refresh Token 和 Client ID，可用于 Graph（OAuth2.0）方式收信。如果你需要批量购买 Hotmail 账号、Hotmail 账号批发、批发 Outlook 邮箱，或购买支持 Graph 的微软邮箱账号，可以根据使用场景选择 Hotmail007 API 快速收信，或自行接入微软 Graph。

本文内容

什么是微软 Graph（OAuth2.0）收信方式
为什么 Graph 收信需要 Refresh Token 和 Client ID
使用 Hotmail007 API 快速获取最新邮件
自行接入微软 Graph 读取邮件
两种收信方式怎么选择
使用 Graph 收信的注意事项

1. 什么是微软 Graph（OAuth2.0）收信方式？

微软 Graph 是微软官方 API，可用于访问 Outlook 邮件、联系人、日历等微软账号数据。

在 Hotmail/Outlook 邮箱收信场景中，Graph（OAuth2.0）方式是通过授权信息读取邮箱数据，而不是只依赖传统邮箱协议。简单来说，以前很多收信方式主要使用邮箱地址和密码连接邮箱服务器；Graph 方式则需要配合 Refresh Token 和 Client ID 完成授权后读取邮件。

它适合验证码邮件读取、自动化收信、批量 Hotmail/Outlook 账号管理，以及将邮箱收信能力接入自己的系统。

如果用户使用第三方收件工具，通常需要按照工具要求填写邮箱、密码、Refresh Token、Client ID 等信息。

2. 为什么 Graph 收信需要 Refresh Token 和 Client ID？

Graph（OAuth2.0）使用授权机制读取邮箱。对于 Hotmail/Outlook 邮箱 Graph 收信来说，Refresh Token 和 Client ID 是非常重要的字段。

Refresh Token：用于维持授权和获取访问权限
Client ID：用于识别对应的授权应用
Access Token：由程序在请求过程中临时获取，普通用户通常不需要手动填写

Hotmail007 提供的 Hotmail/Outlook 邮箱账号都包含 Refresh Token 和 Client ID，常见发货格式为：

邮箱:密码:刷新令牌:客户ID

这种格式可以用于 Hotmail007 API 获取最新邮件，也可以用于第三方收件工具或自行编写代码连接微软 Graph。

需要注意的是，Refresh Token 通常约创建 3 个月有效，具体以账号授权状态为准。Token 到期或失效后，需要更换新的有效 Token 或重新获取授权信息。

部分用户在实际使用中可能会遇到网络环境或 IP 状态影响请求结果的情况。如果 Graph 收信异常，可以先检查 Refresh Token、Client ID、账号格式、请求参数和网络环境。

3. 使用 Hotmail007 API 快速获取最新邮件

Hotmail007 API 适合快速获取指定 Hotmail/Outlook 邮箱中的最新一封邮件。它既可以在网页中直接生成请求链接，也可以通过程序批量调用。

API 文档地址：

https://hotmail007.com/api-docs

进入 API 文档后，找到：

04 获取指定邮箱账号的最新一封邮件

该接口用于通过账号信息、邮箱文件夹和可选时间戳，获取指定邮箱账号的最新一封邮件。

接口地址：

https://gapi.hotmail007.com/open/mail/latest

请求参数：

clientKey：你的 API Key
account：完整邮箱账号信息，格式为 email:password:refreshToken:clientId
folder：邮箱文件夹，只支持 inbox 或 junkemail (inbox 用于获取收件箱最新邮件，junkemail 用于获取垃圾箱最新邮件)
start_timestamp：可选，只返回指定时间之后收到的邮件，Unix 秒级时间戳

3.1 在浏览器中打开链接使用

对于不熟悉编程的用户，可以直接使用 API 文档里的测试接口。

在测试接口中填写 clientKey、account 和 folder 后，页面会自动生成请求示例。复制生成的请求链接，在浏览器中打开，即可查看最新一封邮件。（如下图所示）

这种方式适合临时查看邮件、读取验证码邮件，或者快速测试某个 Hotmail/Outlook 邮箱是否可以正常收信。

3.2 通过程序调用 API

如果需要批量获取最新邮件，可以将 Hotmail007 API 接入脚本或系统中。

Python 示例：

import requests

clientKey = "your_clientKey"
account = "email:password:refreshToken:clientId"
folder = "inbox"

url = "https://gapi.hotmail007.com/open/mail/latest"

resp = requests.get(
    url,
    params={
        "clientKey": clientKey,
        "account": account,
        "folder": folder
    }
)

print(resp.text)

如果需要按时间筛选邮件，可以加入 start_timestamp：

import requests

clientKey = "your_clientKey"
account = "email:password:refreshToken:clientId"
folder = "inbox"
start_timestamp = 1710000000

url = "https://gapi.hotmail007.com/open/mail/latest"

resp = requests.get(
    url,
    params={
        "clientKey": clientKey,
        "account": account,
        "folder": folder,
        "start_timestamp": start_timestamp
    }
)

print(resp.text)

这种方式适合验证码邮件读取、平台注册邮件接收、批量 Hotmail 邮箱收信和 Outlook 邮箱自动化管理。

4. 自行接入微软 Graph 读取邮件

如果你希望直接对接微软官方 Graph API，可以使用完整账号格式中的 Refresh Token 和 Client ID 完成授权请求，然后读取 Outlook 收件箱邮件。相比 Hotmail007 API 主要用于快速获取最新一封邮件，自行接入微软 Graph 更适合需要访问多封邮件、筛选邮件列表或处理更多邮件内容的场景。

基本流程：

准备完整账号格式：email:password:refreshToken:clientId
从账号信息中读取 Refresh Token 和 Client ID
通过 OAuth2.0 接口获取临时访问权限
调用微软 Graph 邮件接口读取 inbox 邮件

Python 示例代码：

import requests


def get_access_token(refresh_token: str, client_id: str) -> str:
    res = requests.post(
        "https://login.microsoftonline.com/common/oauth2/v2.0/token",
        data={
            "client_id": client_id,
            "grant_type": "refresh_token",
            "refresh_token": refresh_token,
            "scope": "https://graph.microsoft.com/.default"
        }
    )
    res.raise_for_status()
    return res.json()["access_token"]


def print_inbox(access_token: str) -> None:
    res = requests.get(
        "https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messages",
        headers={"Authorization": f"Bearer {access_token}"}
    )
    res.raise_for_status()

    for mail in res.json().get("value", []):
        print(f"Subject: {mail.get('subject')}")
        print(f"From: {mail.get('from', {}).get('emailAddress', {}).get('address')}")
        print(f"Text: {mail.get('bodyPreview')}")
        print("-" * 50)


account = "email:password:refreshToken:clientId"

parts = account.split(":")
refresh_token = parts[2]
client_id = parts[3]

access_token = get_access_token(refresh_token, client_id)
print_inbox(access_token)

5. 两种收信方式怎么选择？

如果你只是想快速查看某个 Hotmail/Outlook 邮箱的最新邮件，可以使用 Hotmail007 API 文档中的 Test Interface。填写参数后，复制生成的 Request Example 到浏览器打开即可。

如果你需要批量获取最新邮件，可以直接调用 Hotmail007 API，将接口接入脚本或系统中。

如果你需要更自由地处理邮件内容，例如读取多封邮件、筛选邮件或解析邮件正文，可以自行接入微软 Graph。

简单来说：

快速查看最新邮件：使用 Hotmail007 API 的 Test Interface
批量获取最新邮件：调用 Hotmail007 API
自定义邮件处理逻辑：接入微软 Graph

6. 使用 Graph 收信的注意事项

使用微软 Graph（OAuth2.0）或 Hotmail007 API 收信时，建议重点检查以下信息：

account 格式是否为 email:password:refreshToken:clientId
Refresh Token 是否仍然有效
Client ID 是否正确
folder 是否填写为 inbox 或 junkemail
clientKey 是否正确
请求参数是否完整
网络环境是否稳定

Refresh Token 通常约创建 3 个月有效，具体以账号授权状态为准。为了保证 Hotmail/Outlook 邮件读取稳定，建议定期检查 Token 状态。

总结

微软 Graph（OAuth2.0）是 Hotmail/Outlook 邮箱当前非常主流的 API 收信方式，适合快速收件、验证码读取、自动化邮件处理和批量邮箱管理。

Hotmail007 提供的 Hotmail/Outlook 邮箱账号都包含 Refresh Token 和 Client ID，常见发货格式为邮箱:密码:刷新令牌:客户ID。用户可以通过 Hotmail007 API 快速获取最新邮件，也可以自行使用 Refresh Token 和 Client ID 接入微软 Graph。

如果你需要批量购买 Hotmail 账号、Hotmail 账号批发、批发 Outlook 邮箱、购买支持 Graph（OAuth2.0）的微软邮箱账号，Hotmail007 可以提供账号和 API 支持。